home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Atari Compendium
/
The Atari Compendium (Toad Computers) (1994).iso
/
files
/
umich
/
network
/
ka9q
/
nhclb120.zoo
/
readme.0
< prev
next >
Wrap
Text File
|
1992-12-09
|
7KB
|
225 lines
README and FAQ for the ka9q source code for Unix, Atari-ST and other machines.
====== === ================
by Dave Evans ( devans@hclb.demon.co.uk )
1 December 1992, ver 1.20, from nhclb120.lzh README.0
So, you want to compile ka9q for your machine ? Good for you ! - I
need all the help I can get. I have to warn you that the job you have
taken on is not a piece of cake. The sources are in a mess, there are
innumerable makefiles and readme files, of which this is only the
first.
The current (1/12/92) source file is "nhclb120.lzh", but later versions may
soon exist.
If you are reading this on an Atari ST, you will notice that all files
have the Unix line ending convention. Sorry about that. There are at
least 2 editors that don't make a big deal about about Unix files:
MICROEMACS and EMACS. I suggest you use one of them if your favourite
editor is barfing.
If you haven't already done so, I suggest you try out the executbale
file for your machine and set up a working net. Execuables (binaries)
for the Atari and SCO Unix can be found on gate.demon.co.uk in the
pub/atari and pub/unix directories,(I think) and on CIX in the
tenner.a.month/atari and tenner.a.month/files conferences. I suspect
that the files in /files are more up-to-date.
Make sure you get the latest version, usaully called N89*.lzh. I don't
have any control over either of the two sites, so the files may get
moved or deleted without my knowing. You've probably noticed by now
that my favourite archiver is LHA/LHARC. Sorry about that, but it
does create files 20% smaller than compress, hence saving YOUR BT/Hg
bill. I will always use LHARC version that is compatible with the
oldest ST LHARC.
New versions of net source and executables will be uploaded to
gate.demon.co.uk *ONLY*_, now that Cix has got access to the Internet.
This means, if you are on CIX, that you will have to download the NET
files from the tenner.a.month/files conference first to get access
into gate. Alternatively, you can use the CIX Internet ftp gateway to
get files from gate.demon.co.uk direct into your local Cix directory,
and then download them from there.
The executable archives come with more wonderfull docuemtation, and
some useful configuration files. You will have to edit them for your
setup and hostname, IP address, etc.
CONFESSION
----------
I've never actually got around to trying the NET programs on DIS
(Demon Internet Services ). Other people are using the programs, and
I've had very few complaints -maybe they are too polite.
The ATARI ST version has been tested against the latest PC KA9q, and
also on 386BSD and my SCO Unix version. The SCO Unix version has been
tested against the ST version. The source code for both my versions
is 95% identical, so bugs may be cancelling out.
MAKEFILES
---------
makefile.bsd for BSD Unix, I've tried it and it does not work on 386BSD
makefile.scg + SCO UNIX 3.2.2, gcc 1,39
makefile.stg + ATARI ST, gcc 1,39 gcc 2.0 and later
makefile.stm ATARI ST, Mark Williams C. Probably broken, tested long ago.
makefile.ung Unix, gcc 1.39 not really tested by me
makefile.unx Unix, native compiler, not tested by me
makefile.lnx Linux, under development.
+ = tested and supported by me.
depend.out
----------
The existing depend.out file has been shrunk to save space in the
archive. If you start changing the source, you will have to create a
proper depend.out file. "make depend" on Unix. On the ST there is a GCC
option, which I've forgotten at this moment, to create a dependency
file. You will probably have to edit it by habd into the makefile - I
don't think "include depend.out" works in make files on the ST.
You may find a depend.st file lying around, but I would not bank on it working
properly.
COMPILING
---------
I've tried to get rid of most of the compiler warnings. There are still
a few left, mostly in the AX25 stuff, which we never use ( Amateur
Radio networking). Ignore.
"gcc -Wall" will rip everything to shreds. I daren't uuse it !
BUGS
----
SCO UNIX 3.2.2
You may see the message "bad file descriptor passed for device 0" This
just means that you don't have the serial device set up in your
net.rc. There is no way of quitting form this message - you have to
kill from another terminal
ATARI ST
Telnet crashes when conmnecting to some hosts, it is trying to pass
the ntype of the termial (vt52 or tty). Only vt52 emulation is
supported, and I'm not sure about even that.
Control-C in telnet is buggy,
CR and LF handling is a mess. The gcc library deals with it, and it
conflict with net's . You can see this if someone fingers your finger
files.
The maximum serial buufer size is 32k. I was under the impression it
could be as much as you could allocate.
ENHANCEMENTS from original ka9q
------------
net -x
displays where net expects to find files and directories
telnet host service, service can be a name, eg smtp or telnet - save
looking up RFCs - yeah, big deal.
/ or \ in filenames (ST only)
-----------------------------
nets compiled with gcc libraries don't really care which one you use
on the ST.
VERSION
-------
The curenet verson of net is 1.20 (1/12/92) This is purely a
renumbering exercise, there is no difference from net 1.13.
ORIGINS
-------
The source code for NET came from a site at rutgers.edu. I've
forgetten where exactly where though. It was meant for Linux.
FUTURES
-------
It should be possible to re-integrate the source back into the the
current Linux version.
If I find a suitable NNTP CLIENT source then I will put it in. The
Archimedes can do NNTP, so there is hope yet.
INSTALL
-------
There is an INSTALL file. I think it is meant for Linux. Not tested.
Read the docs.
MORE INFO
---------
see README.*
The latest PC KA9Q
docs in the other ka9q files, N89*.lzh
RFCs from nic.ddn.mil, can be found on gate.demon.co.uk and on Cix in
the RFC conference.
books:
Unix Network Programming, Stevens W. R., ISBN 0-13-949876-1
Computer Networks, Tanenbaum, A. S, ISBN ???
Internetworking with TCP/IP Comer, 2 vols, ISBN ???
Usenet: comp.protocols.tcp-ip.*, comp.os.linux,comp.unix.bsd and many more.
CIX:
conferencces: packet, tenner.a.month, unix, linux, free.software, atari.st (for
the lharc program), cix/internet, internet, sco
DEMON
demon.ip.suppport.*, demon.*
Linux mailing lists fro NET and SLIP
DOCUMEBTATION
-------------
Guy Kewney says it is all incomprehensiblie I don't dispute that.
COPYRIGHTS
----------
The original source code is copyrighted by Phil Karn. My mods are
copyright by me, but can be distributed under whatever conditions the
original source is distributed.
This file can be distributed under the term of the Free Software Foundation'
General Public Licence (GPL).
THE END
-------